4.3.0 版本更新

• 新增 4.3.0 版本更新内容（覆盖 v3.6.0 → v4.3.0 的累积变更），包含 11 个大章节：
• Hermes Agent 深度集成（接入重构、运行状态可视化、技能共享与兼容分流、输出优化）
• Obsidian 知识库集成（多知识库支持、技能与命令搜索增强）
• 模型管理与对话状态（CLI 集成、对话级状态独立、定时任务执行器绑定、调度边界控制）
• 技能系统增强（对话生成技能、内部上下文隔离）
• 流式响应与事件展示优化（流式链路升级、后台事件回放、消息展示优化）
• 记忆系统增强（分类补充、AI 提取增强、事实同步、存储诊断）
• 定时任务增强（候选通知、意图识别优化）
• OpenAI 兼容模型网关
• 连接状态与启动优化
• 分享与归档
• 自动沉淀技能优化

一、Hermes Agent 深度集成

1.1 Hermes 接入重构

• Hermes 已从 Gateway 收敛为 CLI oneshot，聊天中选择 Hermes 后由 Codebot 调用 hermes -z

• Codebot 只作为薄适配层：写入共享配置（模型网关、记忆库、定时任务库、技能目录和 Obsidian 路径），启动 Hermes CLI 子进程，把终端输出持续追加到当前聊天气泡

• 重构后的 Hermes 接入不再导入 Hermes 内部 Agent 类，也不再依赖自定义 runner

• 聊天执行入口已从顶层 hermes -z/--oneshot 切换为 Hermes 官方 --cli chat -q 单次查询路径

• 当 CLI 明确要求确认、继续、密码、密钥或输入时，会在聊天页显示交互面板，并把用户回答写回 Hermes stdin

1.2 Hermes 运行状态可视化

• 若 CLI 长时间暂时没有正文输出，Codebot 会在聊天窗口中持续映射 Hermes 运行状态：包括 session.status 启动状态、session.trace 运行轨迹，以及非阻塞的 session.idle 后台心跳

• 明显像"加载 skill / 调用 tool / 扫描资源 / 运行步骤"的 Hermes 行优先归类成可见的"工具调用"事件，其余普通说明继续归类为"运行轨迹"

• 针对"启动后长时间 0 输出但同消息重试可成功"的间歇性卡死，Codebot 会在 Hermes 启动后连续 90 秒仍无任何 stdout 时自动重试 1 次

1.3 Hermes 技能共享与兼容分流

• Hermes 的 skill 共享模型统一收敛为"目录共享"：Codebot 会把 Hermes Agent 自身默认可发现的 skill 目录、用户手动配置的 Hermes Skill 目录、Codebot 内置/自动生成 skills 目录、以及 OpenCode CLI skill roots 一起并入 Hermes 的有效 skills.external_dirs

• 对于"显式点名且来源于 OpenCode 共享目录"的 skill，Codebot 会先检测 Hermes 兼容分流：运行时证据表明某些 OpenCode-shared skill 会在 Hermes 子进程中长期静默卡住，因此这类请求会透明切换到 OpenCode 原生执行链

• Hermes 不要求用户单独配置模型：聊天主模型跟随当前聊天模型，后台辅助模型跟随"记忆 → 自动整理 → 整理使用模型"

1.4 Hermes 输出优化

• 对 Hermes stdout 使用增量 UTF-8 解码，并过滤 ANSI 控制序列、Rich 边框、Resume this session / session_id / Session 等终端辅助行

• Hermes 执行超时按"空闲无输出/无交互"计算；终止按钮会结束当前 Hermes 进程

• Hermes 模式下沉淀或创建的定时任务会记录 executor=hermes，后续到点触发时继续由 Hermes CLI 执行

二、Obsidian 知识库集成

2.1 多知识库支持

• 设置页中的 Obsidian 标签支持配置默认 Vault 路径与多个知识库路径

• 聊天页通过 # 可多选知识库

• Codebot 会把这些 Markdown 知识库当成原生 Obsidian wiki 结构直接处理，优先引导调用 obsidian-cli 与相关 Obsidian skill 去完成检索、模板调用、读取、写入、移动与 wiki-link 安全操作，不会把知识库先转成向量库

2.2 技能与命令搜索增强

• 聊天输入框中的 @ 会搜索全部技能来源，包括 Codebot 内置/自动生成、OpenCode、Hermes Agent 与 OpenClaw，支持描述、单词和多词搜索

• 聊天输入框中的 / 会搜索 OpenCode CLI 命令，并支持按描述、单词和多词进行匹配

三、模型管理与对话状态

3.1 模型刷新与 CLI 集成

• 聊天页模型刷新会优先调用 opencode models，与 OpenCode CLI 的最新模型列表保持一致

• 若 Codebot 进程 PATH 与终端不同，可在 config.json 的 opencode.cli_path 填写 opencode 可执行文件或所在目录，也可以设置环境变量 CODEBOT_OPENCODE_PATH

• Windows 桌面端还会额外自动探测 %APPDATA%\npm、Scoop shim、WinGet Links、Chocolatey bin 等常见 CLI 安装位置

• Codebot 自己拉起 OpenCode Server 时，会将用户全局 ~/.config/opencode/opencode.json 里的 provider 合并到 data/opencode-config/opencode.json，并通过 OPENCODE_CONFIG_HOME=data/opencode-config 启动 OpenCode

• 刷新模型不会自动切换 OpenCode Server 地址，避免模型列表和实际聊天运行时不一致

3.2 对话级状态独立

• 每个普通对话会独立保存当前模式、模型、Hermes/Obsidian 目标和已选知识库

• 在 B 对话切换模型或处理目标，不会覆盖 A 对话原来的选择

• 新建对话仍会沿用最近主动选择的全局默认模型，创建后再形成自己的独立状态

3.3 定时任务执行器与模型绑定

• 定时任务会持久化 executor 字段。聊天中选择 Hermes 后沉淀的任务、成长候选接受后的任务和手动编辑为 Hermes 的任务，到点执行时会调用 Hermes CLI；选择 OpenCode 或未指定时走 OpenCode

• 聊天中创建定时任务时，会把当时选择的主模型保存为任务的 execution_model；任务执行前会检查该模型是否仍在当前可用模型列表中，如果模型过时或供应商不再提供，会自动回退到"记忆 → 自动整理 → 整理使用模型"

• 在"定时任务"编辑窗口中可以为任务重新选择可用模型

3.4 调度边界控制

• 聊天中的定时任务创建意图由 AI 结构化分类器判断；只有判断为"创建/添加/设置 Codebot 定时任务、提醒或闹钟"时，Codebot 才会写入内置定时任务系统或成长候选

• 普通排错、日志分析和文件处理会继续交给 OpenCode/Hermes CLI，不会被误创建为任务

• Codebot 也不会让 CLI 立即创建 PowerShell 后台作业、Windows schtasks、cron/systemd/launchd 等系统级定时器

四、技能系统增强

4.1 对话生成技能

• 聊天页点击"生成技能"后，后端会先调用 find-skills 搜索并评估现有 skill

• 当最佳结果与需求差异小于 40%（即相似度至少 60%）时，Codebot 会基于该 skill 改造并保存

• 否则会继续调用 skill-creator 创建新 skill

• 最终产物统一迁移或写入 skills/auto_*，在技能页中归类为"自动生成"

4.2 内部上下文隔离

• 技能与 MCP 上下文仅用于内部推理，不向用户直接展示"技能参考"等标签

五、流式响应与事件展示优化

5.1 流式链路升级

• 流式链路采用 prompt_async + /global/event，可实时看到工具调用与文本增量

• 前端按事件实时追加渲染（步骤/工具事件逐条显示，正文增量分块刷新，不等待最终完成）

• 为避免浏览器渲染被单次大量事件阻塞，前端会在流式消费中定期让出事件循环，并将文本增量按帧合并刷新

5.2 后台事件回放

• 从"技能/设置"等页面返回聊天页后，会自动恢复当前对话的"处理中/排队中"状态，并在任务结束后自动刷新最新消息

• 从其他页面返回聊天页后，会按当前对话回放后台执行期间的工具调用事件，并保持原有事件顺序与展示位置

• 后台事件回放与数据库最终消息会做去重收敛，避免同一回复先流式出现后又重复插入一次

5.3 消息展示优化

• 回答入库与展示前会自动清洗 system_policy/conversation_context 等内部提示片段，避免污染最终回复与对话标题

• 聊天时间显示会将 SQLite 的 UTC 时间戳按本地时区换算，并正确显示"刚刚/分钟前/小时前"

• 聊天相对时间会自动刷新，避免时间长期停留在"刚刚"

• 用户手动上滑查看历史消息时，流式更新不再强制自动滚动到底部；仅在接近底部或主动发送消息时自动跟随

• 消息操作按钮（复制/撤销）统一固定在回复气泡右下角

• 应用与对话回复头像使用 logo.ico

六、记忆系统增强

6.1 聊天记忆分类补充

• 聊天中手动"记住"时会优先识别偏好（喜欢/偏好/风格/工具等）和习惯（通常/经常/常用等），再识别联系方式和地址，最后才判断个人信息，避免使用偏好被误归为个人信息或联系人

6.2 AI 记忆提取增强

• AI 自动提取记忆时，系统提示词包含严格的分类边界定义和示例，确保偏好/习惯不被错误归类

6.3 事实同步与删除联动

• 打开活跃记忆列表时，会将生日类事实记忆自动补齐到长期记忆，避免"有事实但列表为空"

• 删除带 memory_key/fact_key 的长期记忆时会同步归档对应事实，防止生日等条目被自动补回

6.4 存储诊断与一键自检

• 提供 /api/memory/storage-status，可直接查看当前数据库路径与表计数

• 活跃记忆页支持"一键自检"，会检测数据库路径、关键表计数和接口读链路状态

七、定时任务增强

7.1 候选通知

• 定时任务页顶部的"开启通知"控制任务候选提醒

• 开启后，聊天或自动整理把定时任务加入"成长候选"时会发送应用内/桌面操作提醒，便于及时打开"成长候选"确认、编辑或接受

7.2 意图识别优化

• 判断依据：同时满足"触发词（提醒/通知/闹钟等）+ 时间或日期线索（每天/周几/几点/10月20日等）"时优先判为定时任务

八、OpenAI 兼容模型网关

• Codebot 提供 OpenAI 兼容接口：GET /v1/models 和 POST /v1/chat/completions

• 使用前请先请求 /v1/models，从返回结果里的 id 选择当前真实可用的模型

• 如果直接调用 HTTP 接口而不是 OpenAI SDK，model 字段可以省略；此时后端会优先使用记忆自动整理模型 memory.organize_model，若未设置则回退到聊天页默认模型

九、连接状态与启动优化

9.1 连接状态刷新

• 聊天页顶部会显示 OpenCode / Bridge / MCP 代理状态，并支持手动刷新连接与模型列表

9.2 OpenCode Server 自动拉起

• 桌面端启动后端时会自动尝试拉起 OpenCode 服务，并统一优先使用 127.0.0.1:11200

• npm start 开发模式也会跟正式版一样优先连到 11200，避免误起另一套 dev server

• 如需覆盖默认值，可设置环境变量 CODEBOT_OPENCODE_PREFERRED_PORT 与 CODEBOT_OPENCODE_FALLBACK_PORT

• 桌面端会强制开启 OpenCode 自动拉起；如果系统里已经有 OpenCode 桌面端或 opencode serve 在运行，Codebot 会直接复用现有健康服务并跳过额外安装检查

9.3 后台自动启动（Windows 任务计划程序）

• 支持通过 Windows 任务计划程序配置 opencode serve 开机自启，详细步骤已写入文档

十、分享与归档

• 点击左侧对话更多菜单里的"分享"后，系统会生成 /share/{share_id} 只读页面，并复制基于局域网地址的链接

• 分享页面只展示对话内容，不提供继续发送消息、删除或修改能力

• 点击"归档"后，对话仍保存在 data/conversations.db 中，conversations.is_archived 会被设置为 1

• 归档后的对话不会显示在聊天页左侧普通对话列表中，可在"日志"页的"已归档对话"标签中查看、搜索和恢复

十一、自动沉淀技能优化

• 自动沉淀技能仅在复杂任务场景触发，过滤寒暄类和系统提示词污染内容，避免生成无意义技能

3.5.0 版本更新

一、技能系统重构：来源分层与调用优先级

1.1 技能来源三分类

1.2 技能调用优先级

1.3 技能兼容性增强

• 技能格式兼容 NousResearch/hermes-agent 项目的设计思路

• 同时兼容 openclaw 的 skill 结构，方便后续扩展和迁移

1.4 技能页面新增功能

• "安装技能"右侧新增 "程序小店" 按钮，打开 https://shop.sanrenjz.com/codebot

• "批量处理"右侧新增 "skill 文件" 按钮，点击后直接打开 自动生成 skill 的存放目录

二、记忆、技能与定时任务沉淀优化

• 记忆、技能、定时任务不再依赖单一触发词，而是从聊天结果、重复任务、稳定行为中持续提炼

• 自动整理时会额外扫描新增聊天记录，联动补充记忆、定时任务与可复用技能沉淀

• "记忆 → 配置 → 自动整理"在设定时间会真正触发整理并补漏，而不只是设置项

• 目标是让系统"越用越懂你"，降低用户手动操作门槛

三、自动升级与 GitHub CI/CD 发布流水线

3.1 GitHub Actions 自动打包

• 参考 sanrenjz-tools 项目，配置了 .github/workflows/release.yml

• 推送 main 分支后自动触发三平台（Windows / macOS / Linux）构建

• 版本号自动按 minor 规则递增：1.1.0 → 1.2.0，1.9.0 → 2.0.0

• 构建产物自动发布到 GitHub Releases

3.2 更新下载修复

• 修复非会员或未登录用户从 GitHub Releases 下载时因资产命名不一致导致的 404 错误

• 统一 Windows 安装包命名规则，确保自动更新链路可靠

• 非会员或未登录用户默认从 GitHub 拉取更新

3.3 对象存储更新（会员专属）

1. 客户端读取 latest.json 获取最新版本号

2. 对比本地版本，若有新版本则提示用户下载

3. 客户端从对应版本目录下载安装包并执行安装

四、会员登录与程序小店联动

4.1 右上角头像登录

• 增加登录功能，站点为 https://shop.sanrenjz.com/

• 应用内登录状态与程序小店会员状态保持联动：在应用内登录 = 在程序小店登录，反之亦然

• 修复登录时出现"An object could not be cloned."的错误

4.2 程序小店内置浏览器

• 在技能页"安装技能"右侧新增入口，打开 https://shop.sanrenjz.com/codebot

• 程序小店在内置浏览器中打开，支持刷新按钮重新加载页面

• 修复用户登录后打开程序小店导致远端站点崩溃的 bug（权限范围已收缩至会员权限）

4.3 会员技能下载

• 会员选择产品后可直接下载，不再弹出保存路径对话框

• 下载的 ZIP 文件自动解压到 自动生成 skill 存放位置

• 下载的技能作为 自动生成 来源被 Codebot 调用

五、UI 与体验优化

5.1 菜单栏精简

• 将"文档"从菜单栏移至"设置"页面的"沙箱配置"右侧，释放菜单空间

5.2 聊天输入框增强

• 支持粘贴截图：用户截图后可直接 Ctrl+V 粘贴图片到对话框

5.3 对话分享修复

• 修复分享链接在浏览器中无法打开对话内容的问题

• 分享链接改为基于局域网 IP，而非 localhost，便于分享给他人访问

5.4 归档对话查看

• 归档的对话统一存放至"日志"页，用户可在日志页查看和恢复归档内容

六、多 Agent 群聊功能

6.1 功能定位

• "多 Agent 群聊"置顶于对话列表，与普通对话区分

• 普通对话有"删除"；群聊对话替换为"清空"，仅清空内容，不删除会话

• "开始群聊"点击后变为"取消群聊"，支持用户随时取消

6.2 多 Agent 协作机制

• 支持串行执行：上一个 Agent 完成后，将结果转交给下一个 Agent

• 支持并行执行：多个 Agent 同时处理各自任务

• 支持终止：用户点击"终止"后，所有参与群聊的对话均停止

6.3 任务过程可见

• 用户发送任务后，"多 Agent 群聊"对话实时回显任务分配流程和各 Agent 的执行状态

• 用户可以清楚看到任务如何被分配、每个 Agent 的处理结果，不再是黑盒

• 内置多 Agent 协作调度技能（skills/multi-agent-collaboration/SKILL.md）

2.8.0 版本更新

一、代码修改与功能新增

1. 对话命名优化
• 修改对话命名规则，使用 AI 总结对话内容进行命名（20 字以内）。
• 优化生成时间：AI 回复后立即生成对话名称，仅截取回复内容的前 300-500 字以减少 Token 消耗。
• 修复显示刷新延迟：对话名称生成后即时刷新显示，无需切换界面才可见。

2. 本地模型网关/代理层调整
• 测试“本地模型网关/代理层”架构，成功后提供 Python 调用教程（中文版）。
• 增强模型调用逻辑：
• 默认情况下，若用户未指定模型，自动调用当前 CodeBot 聊天默认模型。
• 若模型参数为空值时，使用“记忆->自动整理->整理使用模型”作为模型来源。
• 修复接口调用问题：解决示例代码中模型为空时不调用默认模型的 Bug。

3. 文档功能完善
• 在菜单栏“设置”右侧新增“文档”入口。
• 文档内容加载：解决“文档没有内容，加载失败（HTTP 404）”问题，确保文档路径正确。
• 优化 Markdown 渲染：修复文档中网络图片无法显示、代码块渲染不良等相关问题。

4. 技能沉淀与沙箱检查
• 技能沉淀功能：检查技能沉淀逻辑是否正常，确保当日聊天内容可以被记忆、定时任务处理和复杂重复性内容可自动生成技能。
• 沙箱与性能检查：检查沙箱功能是否存在问题，分析高 CPU/内存占用是否由异常进程或重复运行的程序引起，修复潜在卡顿问题。

二、Bug 修复与优化

1. 修复 CodeBot 启动冲突：解决 Opencode 桌面端无法打开 CodeBot 并报错“Network service crashed”的问题。

2. 提升 CodeBot 启动速度：检查 npm start 启动缓慢问题，优化界面加载顺序，优先显示界面以增强用户体验。

3. 优化文档与对话展示：修复对话名称延迟刷新及文档渲染错误，提升系统响应速度与稳定性。

项目

一、项目概述

• 与 OpenCode 服务无缝集成，支持多模型切换与自主决策

• 实现对用户信息、习惯、偏好的自动提取与记忆提示

• 完备的定时任务、通知、日志、技能、MCP 集成与管理

• 安全隔离的沙箱执行环境，大幅提升代码生成和运行的灵活性与安全性

• 跨平台兼容（支持 Windows、Linux、macOS，及 Electron 桌面端）

二、功能结构与主流程

2.1 主模块启动流程

• 应用初始化 → 数据/技能/日志/备份目录校验与创建 → 内置技能复制

• 依赖检查与自动安装（OpenCode）

• 连接数据库并初始化表结构

• 各全局核心组件实例化（内存管理、通知、WS 机器人、沙箱等）

• API 路由加载（chat/memory/scheduler/skills/config/mcp/etc.）

• 沙箱环境启动与端口自适应检测

• 异步启动 OpenCode Server 并接管后端与技能调度

• 前端静态资源挂载、SPA 路由回退

• 应用关闭时 graceful shutdown，停止后台任务、断开连接

2.2 Codebot 作为第三方的工作方式

三、核心功能详解

3.1 OpenCode 会话系统

• 对话管理: 创建和管理多个对话，支持重命名、置顶、归档、删除

• OpenCode 主控: 所有消息统一交给 OpenCode 处理，Codebot 只负责提供第三方能力和结果展示

• 历史查看: 进入"聊天"自动打开最近对话，支持多对话并行处理

• 分组聊天: 支持将多个对话合并为群组模式

• 对话分享: 生成分享链接（share_id），可供他人只读查看

• 意图分类: 消息自动分类为"定时任务/保存记忆/普通对话"，避免误判

• Agent 模式: 支持 plan（结构化规划）和 build（直接执行）两种模式

• 文件附件: 支持文件附件上传；多模态模型支持图片分析

• 流式响应: 流式展示 OpenCode 步骤事件（如 step-start / step-finish）与回复增量

• 会话复用: 同一对话默认复用 OpenCode 会话，减少上下文丢失，提升连续追问一致性

• 后台执行: 切换到"技能/设置"等页面时，任务继续在后台执行，返回聊天页自动恢复状态并回放工具调用事件

3.2 记忆系统

• 上下文记忆: 自动保存对话历史

• 长期记忆: 保存用户习惯、偏好、事实信息（用于之后对话检索问答）

• 自动提取: 每次对话后，后台自动进行规则+AI双通道提取，识别重要信息并保存，无需依赖"记住"关键词

• 记忆类别: habit（习惯）、preference（偏好）、profile（个人信息）、note（笔记）、contact（联系人）、address（地址）

• 记忆提示: 聊天输入时自动检索相关记忆并在输入框上方显示提示气泡，AI 回复时也会注明"根据我的记忆"

• 记忆搜索: 语义搜索相关记忆

• 记忆归档: 自动或手动归档旧记忆，支持按类别过滤查看

• 备份恢复: 导出记忆为 ZIP 文件（保存至 data/backups/），或上传备份文件恢复

• 记忆整理: 每日在配置时间点（默认 03:00）自动用 AI 对活跃记忆进行优化（合并重复、补全描述、标准化格式、修正矛盾），也可手动触发

• 聊天整理联动: 自动整理时会扫描新增聊天记录，从聊天中补充记忆，并尝试沉淀相关定时任务与可复用技能

3.3 定时任务系统

• Cron 表达式: 完整的 Cron 语法支持

• 智能时间解析: 自动从用户消息中区分"时间部分"和"任务内容"。例如"5分钟后，写首春天的诗保存到D盘"会解析为：调度时间=5分钟后，任务=写首春天的诗保存到D盘

• 意图识别: 本地规则优先分流"定时任务/记忆/普通对话"，避免"保存到D盘"这类任务被误判为记忆

• 生日提醒特例: 对"记住我的生日，10月20日，我生日时提醒我"这类复合句，会同时保存生日记忆并创建每年生日提醒任务

• AI 辅助: 自然语言生成 Cron 表达式（OpenCode 不可用时降级为本地规则解析）

• 通知渠道: 飞书/邮箱/应用内通知

• 执行日志: 详细的任务执行记录

• 提醒任务: 带 __REMINDER__ 标志的纯提醒任务不依赖 OpenCode 也能按计划触发通知；AI 类任务（生成内容/写文件等）需要 OpenCode 在线执行

• 像聊天一样执行: 定时任务到达执行时间时，系统会像聊天一样通过 OpenCode CLI 处理任务内容，充分利用 AI 的代码生成与文件写入能力

• 一次性任务: 未强调重复性的任务（如"5分钟后"、"明天"）自动标记为一次性，执行完成后不再重复触发

3.4 技能系统

• 内置技能: web_search（网页搜索）、web_fetch（抓取网页）、news（新闻获取）、file_reader（文件读取）、pdf（PDF 处理）、docx（Word 文档）、pptx（PowerPoint）、xlsx（Excel）、ai-company（AI 专家团队决策）、expert-agents（14位专家人设）、code-review（代码审查）、writing-plans（写作计划）、subagent-driven-development（子代理驱动开发）、arxiv-research（论文研究）、blogwatcher（博客监控）、obsidian-notes（Obsidian 笔记）、self-improving（自我改进）、systematic-debugging（系统化调试）、test-driven-development（测试驱动开发）

• 技能定义: Markdown 文件（SKILL.md）带 YAML front-matter（name、description），自动匹配用户提示

• 自动调度: tool_dispatcher.py 通过关键词 + 语义匹配，将 SKILL.md 内容注入到对应请求的提示词中

• 低干扰注入: 仅在高相关度下启用技能上下文，降低无关技能误触发

• 自动沉淀技能: 对高复用的已完成任务，自动生成可复用技能元数据，便于后续任务快速命中

• OpenCode 本地技能: 自动读取 ~/.agents/skills，可在技能页卸载

• 自定义目录技能: 支持配置多个外部文件夹路径，自动扫描其中包含 SKILL.md 的子目录并加载为只读技能

3.5 MCP 服务器管理

• 支持 stdio 和 SSE 两种传输模式的 MCP 服务器配置

• SSE 模式的 MCP 工具由 tool_dispatcher.py 自动调用：当用户提示词匹配到工具描述时，后端自动发起工具调用并将结果注入上下文

• 完整 CRUD 管理界面（/mcp 页面）及 REST API（/api/mcp）

• 魔搭 ModelScope MCP 集成：Codebot 统一代理外部 MCP 服务器，OpenCode 只需要连接 codebot 这一个第三方 MCP

3.6 沙箱执行环境

• 工作目录隔离执行环境，AI 生成的代码在独立 data/sandbox_workspace/ 目录中运行

• 无需安装额外软件：移除 QEMU/Docker 依赖，开箱即用

• 基于 asyncio.create_subprocess_shell 执行命令，支持超时控制

• 完整输出捕获：stdout、stderr、exit_code

• 执行模式：local（工作目录隔离）

• 可配置执行超时（秒，默认 300）

3.7 通知系统

• 应用内通知: 默认启用，在右上角查看

• 系统桌面通知: 推送至操作系统通知中心（Windows/macOS/Linux）

• 飞书通知: 配置 Webhook URL，支持长连接订阅模式（无需公网 IP）

• 邮箱通知: 配置 SMTP 服务器，支持一键发送测试邮件验证配置

4.1 目录结构自动管理

4.2 沙箱隔离环境（sandbox_manager）

• 隔离执行：防止异常/恶意代码危害主系统

• 支持 stdout/stderr/exit_code 管理与实时反馈

4.3 Memory 及知识库管理

4.4 技能与 MCP 工具自动发现与调度

• ol生成技能沉淀

• 各技能支持内链调用

4.5 网络端口、多实例检测和优雅降级

五、核心代码流程图（Mermaid）

六、主要依赖与技术栈

• Python 3.11+，FastAPI，asyncio，SQLite，ChromaDB，loguru

• Electron, Node.js (前端打包/桌面)，Vue 3, Pinia

• 依赖自动检测（OpenCode CLI），跨平台兼容

七、局限与改进建议

局限：

• 依赖 Electron+Python 环境，首次安装环境配置复杂

• 需保证 OpenCode Server 正常运行方可使用绝大部分 AI 驱动功能

• 技能文件的自动沉淀仅依赖本地规则，用户自行管理自定义目录时须注意格式兼容

改进建议：

• 增强多模型 AI 后端兼容性（如深度集成 OpenAI API）

• 前端适配移动端用户体验进一步优化

• 技能市场与一键安装功能完善，降低维护门槛

• 增加云端备份及远程协作能力